package com.hvgroup.modules.sanic.service;

import java.util.Map;

public interface FileChatService {

    /**
     * 读取excel前两行内容
     * @param fileUrl
     * @return
     */
    String readExcel(String fileUrl);

    /**
     * 仅读取第一个工作表或 CSV 文件的列名
     */
    String readFileColumns(String fileUrl);

    /**
     * 执行大模型查询代理（调用 Python 脚本）
     *
     * @param fileUrl 远程 Excel / CSV 文件地址（预签名 URL）
     * @param queryText 用户问题
     * @return Python 脚本返回的 JSON 字符串
     */
    String queryExcel(String fileUrl, String queryText);

    Map<String, Object> processFileLlmQuery(String fileKey, String bodyStr);

}
